package com.xisoft.common.useragentutils;

import java.util.ArrayList;
import java.util.List;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * Enum constants for most common browsers, including e-mail clients and bots.
 * @qualiFild pers.bc.utils.useragentutils.Browser.java<br>
 * @author：LiBencheng<br>
 * @date Created on 2020-10-22<br>
 * @version 1.0<br>
 */
public enum Browser
{
    
    /**
     * Outlook email client
     */
    OUTLOOK(Manufacturer.MICROSOFT, null, 100, "Outlook", new String[]{"MSOffice"}, null, BrowserType.EMAIL_CLIENT, RenderingEngine.WORD,
            "MSOffice (([0-9]+))"), // before IE7
    /**
     * Microsoft Outlook 2007 identifies itself as MSIE7 but uses the html rendering engine of Word 2007.
     * Example user agent: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0; SLCC1; .NET CLR 2.0.50727; .NET
     * CLR 3.0.04506; .NET CLR 1.1.4322; MSOffice 12)
     */
    OUTLOOK2007(Manufacturer.MICROSOFT, Browser.OUTLOOK, 107, "Outlook 2007", new String[]{"MSOffice 12"}, null, BrowserType.EMAIL_CLIENT,
            RenderingEngine.WORD, null), // before IE7
    OUTLOOK2013(Manufacturer.MICROSOFT, Browser.OUTLOOK, 109, "Outlook 2013", new String[]{"Microsoft Outlook 15"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.WORD, null), // before IE7
    /**
     * Outlook 2010 is still using the rendering engine of Word. http://www.fixoutlook.org
     */
    OUTLOOK2010(Manufacturer.MICROSOFT, Browser.OUTLOOK, 108, "Outlook 2010", new String[]{"MSOffice 14", "Microsoft Outlook 14"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.WORD, null), // before IE7
    
    /**
     * Family of Internet Explorer browsers
     */
    IE(Manufacturer.MICROSOFT, null, 1, "Internet Explorer", new String[]{"MSIE", "Trident", "IE "}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, "MSIE (([\\d]+)\\.([\\w]+))"), // before Mozilla
    /**
     * Since version 7 Outlook Express is identifying itself. By detecting Outlook Express we can not identify
     * the Internet Explorer version which is probably used for the rendering. Obviously this product is now
     * called Windows Live Mail Desktop or just Windows Live Mail.
     */
    OUTLOOK_EXPRESS7(Manufacturer.MICROSOFT, Browser.IE, 110, "Windows Live Mail", new String[]{"Outlook-Express/7.0"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.TRIDENT, null), // before IE7, previously known as
                                                                      // Outlook Express. First released in
                                                                      // 2006, offered with different name
                                                                      // later
    /**
     * Since 2007 the mobile edition of Internet Explorer identifies itself as IEMobile in the user-agent. If
     * previous versions have to be detected, use the operating system information as well.
     */
    IEMOBILE11(Manufacturer.MICROSOFT, Browser.IE, 125, "IE Mobile 11", new String[]{"IEMobile/11"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.TRIDENT, null), // before MSIE strings
    IEMOBILE10(Manufacturer.MICROSOFT, Browser.IE, 124, "IE Mobile 10", new String[]{"IEMobile/10"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.TRIDENT, null), // before MSIE strings
    IEMOBILE9(Manufacturer.MICROSOFT, Browser.IE, 123, "IE Mobile 9", new String[]{"IEMobile/9"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.TRIDENT, null), // before MSIE strings
    IEMOBILE7(Manufacturer.MICROSOFT, Browser.IE, 121, "IE Mobile 7", new String[]{"IEMobile 7"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.TRIDENT, null), // before MSIE strings
    IEMOBILE6(Manufacturer.MICROSOFT, Browser.IE, 120, "IE Mobile 6", new String[]{"IEMobile 6"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.TRIDENT, null), // before MSIE
    IE11(Manufacturer.MICROSOFT, Browser.IE, 95, "Internet Explorer 11", new String[]{"Trident/7", "IE 11."}, new String[]{"MSIE 7"},
            BrowserType.WEB_BROWSER, RenderingEngine.TRIDENT, "(?:Trident\\/7|IE)(?:\\.[0-9]*;)?(?:.*rv:| )(([0-9]+)\\.?([0-9]+))"),   // before
                                                                                                                                     // Mozilla
    IE10(Manufacturer.MICROSOFT, Browser.IE, 92, "Internet Explorer 10", new String[]{"MSIE 10"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, null),   // before MSIE
    IE9(Manufacturer.MICROSOFT, Browser.IE, 90, "Internet Explorer 9", new String[]{"MSIE 9"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, null),   // before MSIE
    IE8(Manufacturer.MICROSOFT, Browser.IE, 80, "Internet Explorer 8", new String[]{"MSIE 8"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, null),   // before MSIE
    IE7(Manufacturer.MICROSOFT, Browser.IE, 70, "Internet Explorer 7", new String[]{"MSIE 7"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, null),   // before MSIE
    IE6(Manufacturer.MICROSOFT, Browser.IE, 60, "Internet Explorer 6", new String[]{"MSIE 6"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, null),   // before MSIE
    IE5_5(Manufacturer.MICROSOFT, Browser.IE, 55, "Internet Explorer 5.5", new String[]{"MSIE 5.5"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, null), // before MSIE
    IE5(Manufacturer.MICROSOFT, Browser.IE, 50, "Internet Explorer 5", new String[]{"MSIE 5"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.TRIDENT, null), // before MSIE
    
    /**
     * Google Chrome browser
     */
    CHROME(Manufacturer.GOOGLE, null, 1, "Chrome", new String[]{"Chrome", "CrMo", "CriOS"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, "Chrome\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), // before
                                                                                                                          // Mozilla
    CHROME_MOBILE(Manufacturer.GOOGLE, Browser.CHROME, 100, "Chrome Mobile", new String[]{"CrMo", "CriOS", "Mobile Safari"}, null,
            BrowserType.MOBILE_BROWSER, RenderingEngine.WEBKIT, "(?:CriOS|CrMo|Chrome)\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), CHROME40(
            Manufacturer.GOOGLE, Browser.CHROME, 45, "Chrome 40", new String[]{"Chrome/40"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME39(Manufacturer.GOOGLE, Browser.CHROME, 44, "Chrome 39", new String[]{"Chrome/39"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME38(Manufacturer.GOOGLE, Browser.CHROME, 43, "Chrome 38", new String[]{"Chrome/38"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME37(Manufacturer.GOOGLE, Browser.CHROME, 42, "Chrome 37", new String[]{"Chrome/37"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME36(Manufacturer.GOOGLE, Browser.CHROME, 41, "Chrome 36", new String[]{"Chrome/36"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME35(Manufacturer.GOOGLE, Browser.CHROME, 40, "Chrome 35", new String[]{"Chrome/35"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME34(Manufacturer.GOOGLE, Browser.CHROME, 39, "Chrome 34", new String[]{"Chrome/34"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME33(Manufacturer.GOOGLE, Browser.CHROME, 38, "Chrome 33", new String[]{"Chrome/33"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME32(Manufacturer.GOOGLE, Browser.CHROME, 37, "Chrome 32", new String[]{"Chrome/32"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME31(Manufacturer.GOOGLE, Browser.CHROME, 36, "Chrome 31", new String[]{"Chrome/31"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME30(Manufacturer.GOOGLE, Browser.CHROME, 35, "Chrome 30", new String[]{"Chrome/30"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME29(Manufacturer.GOOGLE, Browser.CHROME, 34, "Chrome 29", new String[]{"Chrome/29"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME28(Manufacturer.GOOGLE, Browser.CHROME, 33, "Chrome 28", new String[]{"Chrome/28"}, new String[]{"OPR/", "Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME27(Manufacturer.GOOGLE, Browser.CHROME, 32, "Chrome 27", new String[]{"Chrome/27"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME26(Manufacturer.GOOGLE, Browser.CHROME, 31, "Chrome 26", new String[]{"Chrome/26"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME25(Manufacturer.GOOGLE, Browser.CHROME, 30, "Chrome 25", new String[]{"Chrome/25"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME24(Manufacturer.GOOGLE, Browser.CHROME, 29, "Chrome 24", new String[]{"Chrome/24"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME23(Manufacturer.GOOGLE, Browser.CHROME, 28, "Chrome 23", new String[]{"Chrome/23"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME22(Manufacturer.GOOGLE, Browser.CHROME, 27, "Chrome 22", new String[]{"Chrome/22"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME21(Manufacturer.GOOGLE, Browser.CHROME, 26, "Chrome 21", new String[]{"Chrome/21"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME20(Manufacturer.GOOGLE, Browser.CHROME, 25, "Chrome 20", new String[]{"Chrome/20"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME19(Manufacturer.GOOGLE, Browser.CHROME, 24, "Chrome 19", new String[]{"Chrome/19"}, new String[]{"Web Preview"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME18(Manufacturer.GOOGLE, Browser.CHROME, 23, "Chrome 18", new String[]{"Chrome/18"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME17(Manufacturer.GOOGLE, Browser.CHROME, 22, "Chrome 17", new String[]{"Chrome/17"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME16(Manufacturer.GOOGLE, Browser.CHROME, 21, "Chrome 16", new String[]{"Chrome/16"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME15(Manufacturer.GOOGLE, Browser.CHROME, 20, "Chrome 15", new String[]{"Chrome/15"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME14(Manufacturer.GOOGLE, Browser.CHROME, 19, "Chrome 14", new String[]{"Chrome/14"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME13(Manufacturer.GOOGLE, Browser.CHROME, 18, "Chrome 13", new String[]{"Chrome/13"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME12(Manufacturer.GOOGLE, Browser.CHROME, 17, "Chrome 12", new String[]{"Chrome/12"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME11(Manufacturer.GOOGLE, Browser.CHROME, 16, "Chrome 11", new String[]{"Chrome/11"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME10(Manufacturer.GOOGLE, Browser.CHROME, 15, "Chrome 10", new String[]{"Chrome/10"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME9(Manufacturer.GOOGLE, Browser.CHROME, 10, "Chrome 9", new String[]{"Chrome/9"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    CHROME8(Manufacturer.GOOGLE, Browser.CHROME, 5, "Chrome 8", new String[]{"Chrome/8"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null), // before Mozilla
    
    OMNIWEB(Manufacturer.OTHER, null, 2, "Omniweb", new String[]{"OmniWeb"}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), //
    
    SAFARI(Manufacturer.APPLE, null, 1, "Safari", new String[]{"Safari"},
            new String[]{"OPR/", "Coast/", "Web Preview", "Googlebot-Mobile"}, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "Version\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?)"),  // before AppleWebKit
    BLACKBERRY10(Manufacturer.BLACKBERRY, Browser.SAFARI, 10, "BlackBerry", new String[]{"BB10"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.WEBKIT, null), MOBILE_SAFARI(Manufacturer.APPLE, Browser.SAFARI, 2, "Mobile Safari", new String[]{
        "Mobile Safari",
        "Mobile/"}, new String[]{"Coast/", "Googlebot-Mobile"}, BrowserType.MOBILE_BROWSER, RenderingEngine.WEBKIT, null),  // before
                                                                                                                           // Safari
    SILK(Manufacturer.AMAZON, Browser.SAFARI, 15, "Silk", new String[]{"Silk/"}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "Silk\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?(\\-[\\w]+)?)"),  // http://en.wikipedia.org/wiki/Amazon_Silk
    SAFARI6(Manufacturer.APPLE, Browser.SAFARI, 6, "Safari 6", new String[]{"Version/6"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null),  // before AppleWebKit
    SAFARI5(Manufacturer.APPLE, Browser.SAFARI, 3, "Safari 5", new String[]{"Version/5"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, null),  // before AppleWebKit
    SAFARI4(Manufacturer.APPLE, Browser.SAFARI, 4, "Safari 4", new String[]{"Version/4"}, new String[]{"Googlebot-Mobile"},
            BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null),  // before AppleWebKit
    
    /**
     * Opera Coast mobile browser, http://en.wikipedia.org/wiki/Opera_Coast
     */
    COAST(Manufacturer.OPERA, null, 500, "Opera", new String[]{" Coast/"}, null, BrowserType.MOBILE_BROWSER, RenderingEngine.WEBKIT,
            "Coast\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), COAST1(Manufacturer.OPERA, Browser.COAST, 501, "Opera",
            new String[]{" Coast/1."}, null, BrowserType.MOBILE_BROWSER, RenderingEngine.WEBKIT,
            "Coast\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"),
    
    OPERA(Manufacturer.OPERA, null, 1, "Opera", new String[]{" OPR/", "Opera"}, null, BrowserType.WEB_BROWSER, RenderingEngine.PRESTO,
            "Opera\\/(([\\d]+)\\.([\\w]+))"),   // before MSIE
    OPERA_MINI(Manufacturer.OPERA, Browser.OPERA, 20, "Opera Mini", new String[]{"Opera Mini"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.PRESTO, null), // Opera for mobile devices
    OPERA25(Manufacturer.OPERA, Browser.OPERA, 25, "Opera 25", new String[]{"OPR/25."}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.WEBKIT, "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA24(Manufacturer.OPERA, Browser.OPERA, 24,
            "Opera 24", new String[]{"OPR/24."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA23(Manufacturer.OPERA, Browser.OPERA, 23, "Opera 23",
            new String[]{"OPR/23."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA20(Manufacturer.OPERA, Browser.OPERA, 21, "Opera 20",
            new String[]{"OPR/20."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA19(Manufacturer.OPERA, Browser.OPERA, 19, "Opera 19",
            new String[]{"OPR/19."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA18(Manufacturer.OPERA, Browser.OPERA, 18, "Opera 18",
            new String[]{"OPR/18."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA17(Manufacturer.OPERA, Browser.OPERA, 17, "Opera 17",
            new String[]{"OPR/17."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA16(Manufacturer.OPERA, Browser.OPERA, 16, "Opera 16",
            new String[]{"OPR/16."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA15(Manufacturer.OPERA, Browser.OPERA, 15, "Opera 15",
            new String[]{"OPR/15."}, null, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT,
            "OPR\\/(([\\d]+)\\.([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"), OPERA12(Manufacturer.OPERA, Browser.OPERA, 12, "Opera 12",
            new String[]{"Opera/12", "Version/12."}, null, BrowserType.WEB_BROWSER, RenderingEngine.PRESTO,
            "Version\\/(([\\d]+)\\.([\\w]+))"), OPERA11(Manufacturer.OPERA, Browser.OPERA, 11, "Opera 11", new String[]{"Version/11."},
            null, BrowserType.WEB_BROWSER, RenderingEngine.PRESTO, "Version\\/(([\\d]+)\\.([\\w]+))"), OPERA10(Manufacturer.OPERA,
            Browser.OPERA, 10, "Opera 10", new String[]{"Opera/9.8"}, null, BrowserType.WEB_BROWSER, RenderingEngine.PRESTO,
            "Version\\/(([\\d]+)\\.([\\w]+))"), OPERA9(Manufacturer.OPERA, Browser.OPERA, 5, "Opera 9", new String[]{"Opera/9"}, null,
            BrowserType.WEB_BROWSER, RenderingEngine.PRESTO, null), KONQUEROR(Manufacturer.OTHER, null, 1, "Konqueror",
            new String[]{"Konqueror"}, null, BrowserType.WEB_BROWSER, RenderingEngine.KHTML,
            "Konqueror\\/(([0-9]+)\\.?([\\w]+)?(-[\\w]+)?)"),
    
    DOLFIN2(Manufacturer.SAMSUNG, null, 1, "Samsung Dolphin 2", new String[]{"Dolfin/2"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.WEBKIT, null), // webkit based browser for the bada os
    
    /*
     * Apple WebKit compatible client. Can be a browser or an application with embedded browser using
     * UIWebView.
     */
    APPLE_WEB_KIT(Manufacturer.APPLE, null, 50, "Apple WebKit", new String[]{"AppleWebKit"}, new String[]{
        "OPR/",
        "Web Preview",
        "Googlebot-Mobile"}, BrowserType.WEB_BROWSER, RenderingEngine.WEBKIT, null), // Microsoft
                                                                                     // Entrourage/Outlook
                                                                                     // 2010 also only
                                                                                     // identifies itself as
                                                                                     // AppleWebKit
    APPLE_ITUNES(Manufacturer.APPLE, Browser.APPLE_WEB_KIT, 52, "iTunes", new String[]{"iTunes"}, null, BrowserType.APP,
            RenderingEngine.WEBKIT, null), // Microsoft Entrourage/Outlook 2010 also only identifies itself as
                                           // AppleWebKit
    APPLE_APPSTORE(Manufacturer.APPLE, Browser.APPLE_WEB_KIT, 53, "App Store", new String[]{"MacAppStore"}, null, BrowserType.APP,
            RenderingEngine.WEBKIT, null), // Microsoft Entrourage/Outlook 2010 also only identifies itself as
                                           // AppleWebKit
    ADOBE_AIR(Manufacturer.ADOBE, Browser.APPLE_WEB_KIT, 1, "Adobe AIR application", new String[]{"AdobeAIR"}, null, BrowserType.APP,
            RenderingEngine.WEBKIT, null), // Microsoft Entrourage/Outlook 2010 also only identifies itself as
                                           // AppleWebKit
    
    LOTUS_NOTES(Manufacturer.OTHER, null, 3, "Lotus Notes", new String[]{"Lotus-Notes"}, null, BrowserType.EMAIL_CLIENT,
            RenderingEngine.OTHER, "Lotus-Notes\\/(([\\d]+)\\.([\\w]+))"),  // before Mozilla
    
    CAMINO(Manufacturer.OTHER, null, 5, "Camino", new String[]{"Camino"}, null, BrowserType.WEB_BROWSER, RenderingEngine.GECKO,
            "Camino\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?)"),  // using Gecko Engine
    CAMINO2(Manufacturer.OTHER, Browser.CAMINO, 17, "Camino 2", new String[]{"Camino/2"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    
    FLOCK(Manufacturer.OTHER, null, 4, "Flock", new String[]{"Flock"}, null, BrowserType.WEB_BROWSER, RenderingEngine.GECKO,
            "Flock\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?)"),
    
    FIREFOX(Manufacturer.MOZILLA, null, 10, "Firefox", new String[]{"Firefox"}, new String[]{"ggpht.com"}, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, "Firefox\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"),  // using
                                                                                                 // Gecko
                                                                                                 // Engine
    FIREFOX3MOBILE(Manufacturer.MOZILLA, Browser.FIREFOX, 31, "Firefox 3 Mobile", new String[]{"Firefox/3.5 Maemo"}, null,
            BrowserType.MOBILE_BROWSER, RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX_MOBILE(Manufacturer.MOZILLA, Browser.FIREFOX, 200, "Firefox Mobile", new String[]{"Mobile"}, null, BrowserType.MOBILE_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX_MOBILE23(Manufacturer.MOZILLA, FIREFOX_MOBILE, 223, "Firefox Mobile 23", new String[]{"Firefox/23"}, null,
            BrowserType.MOBILE_BROWSER, RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX40(Manufacturer.MOZILLA, Browser.FIREFOX, 217, "Firefox 40", new String[]{"Firefox/40"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX39(Manufacturer.MOZILLA, Browser.FIREFOX, 216, "Firefox 39", new String[]{"Firefox/39"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX38(Manufacturer.MOZILLA, Browser.FIREFOX, 215, "Firefox 38", new String[]{"Firefox/38"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX37(Manufacturer.MOZILLA, Browser.FIREFOX, 214, "Firefox 37", new String[]{"Firefox/37"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX36(Manufacturer.MOZILLA, Browser.FIREFOX, 213, "Firefox 36", new String[]{"Firefox/36"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX35(Manufacturer.MOZILLA, Browser.FIREFOX, 212, "Firefox 35", new String[]{"Firefox/35"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX34(Manufacturer.MOZILLA, Browser.FIREFOX, 211, "Firefox 34", new String[]{"Firefox/34"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX33(Manufacturer.MOZILLA, Browser.FIREFOX, 210, "Firefox 33", new String[]{"Firefox/33"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX32(Manufacturer.MOZILLA, Browser.FIREFOX, 109, "Firefox 32", new String[]{"Firefox/32"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX31(Manufacturer.MOZILLA, Browser.FIREFOX, 310, "Firefox 31", new String[]{"Firefox/31"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX30(Manufacturer.MOZILLA, Browser.FIREFOX, 300, "Firefox 30", new String[]{"Firefox/30"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX29(Manufacturer.MOZILLA, Browser.FIREFOX, 290, "Firefox 29", new String[]{"Firefox/29"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX28(Manufacturer.MOZILLA, Browser.FIREFOX, 280, "Firefox 28", new String[]{"Firefox/28"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX27(Manufacturer.MOZILLA, Browser.FIREFOX, 108, "Firefox 27", new String[]{"Firefox/27"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX26(Manufacturer.MOZILLA, Browser.FIREFOX, 107, "Firefox 26", new String[]{"Firefox/26"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX25(Manufacturer.MOZILLA, Browser.FIREFOX, 106, "Firefox 25", new String[]{"Firefox/25"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX24(Manufacturer.MOZILLA, Browser.FIREFOX, 105, "Firefox 24", new String[]{"Firefox/24"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX23(Manufacturer.MOZILLA, Browser.FIREFOX, 104, "Firefox 23", new String[]{"Firefox/23"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX22(Manufacturer.MOZILLA, Browser.FIREFOX, 103, "Firefox 22", new String[]{"Firefox/22"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX21(Manufacturer.MOZILLA, Browser.FIREFOX, 102, "Firefox 21", new String[]{"Firefox/21"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX20(Manufacturer.MOZILLA, Browser.FIREFOX, 101, "Firefox 20", new String[]{"Firefox/20"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX19(Manufacturer.MOZILLA, Browser.FIREFOX, 100, "Firefox 19", new String[]{"Firefox/19"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX18(Manufacturer.MOZILLA, Browser.FIREFOX, 99, "Firefox 18", new String[]{"Firefox/18"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX17(Manufacturer.MOZILLA, Browser.FIREFOX, 98, "Firefox 17", new String[]{"Firefox/17"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX16(Manufacturer.MOZILLA, Browser.FIREFOX, 97, "Firefox 16", new String[]{"Firefox/16"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX15(Manufacturer.MOZILLA, Browser.FIREFOX, 96, "Firefox 15", new String[]{"Firefox/15"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX14(Manufacturer.MOZILLA, Browser.FIREFOX, 95, "Firefox 14", new String[]{"Firefox/14"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX13(Manufacturer.MOZILLA, Browser.FIREFOX, 94, "Firefox 13", new String[]{"Firefox/13"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX12(Manufacturer.MOZILLA, Browser.FIREFOX, 93, "Firefox 12", new String[]{"Firefox/12"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX11(Manufacturer.MOZILLA, Browser.FIREFOX, 92, "Firefox 11", new String[]{"Firefox/11"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX10(Manufacturer.MOZILLA, Browser.FIREFOX, 91, "Firefox 10", new String[]{"Firefox/10"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX9(Manufacturer.MOZILLA, Browser.FIREFOX, 90, "Firefox 9", new String[]{"Firefox/9"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX8(Manufacturer.MOZILLA, Browser.FIREFOX, 80, "Firefox 8", new String[]{"Firefox/8"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX7(Manufacturer.MOZILLA, Browser.FIREFOX, 70, "Firefox 7", new String[]{"Firefox/7"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX6(Manufacturer.MOZILLA, Browser.FIREFOX, 60, "Firefox 6", new String[]{"Firefox/6"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX5(Manufacturer.MOZILLA, Browser.FIREFOX, 50, "Firefox 5", new String[]{"Firefox/5"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX4(Manufacturer.MOZILLA, Browser.FIREFOX, 40, "Firefox 4", new String[]{"Firefox/4"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX3(Manufacturer.MOZILLA, Browser.FIREFOX, 30, "Firefox 3", new String[]{"Firefox/3"}, new String[]{"ggpht.com"},
            BrowserType.WEB_BROWSER, RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX2(Manufacturer.MOZILLA, Browser.FIREFOX, 20, "Firefox 2", new String[]{"Firefox/2"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    FIREFOX1_5(Manufacturer.MOZILLA, Browser.FIREFOX, 15, "Firefox 1.5", new String[]{"Firefox/1.5"}, null, BrowserType.WEB_BROWSER,
            RenderingEngine.GECKO, null),  // using Gecko Engine
    
    /*
     * Thunderbird email client, based on the same Gecko engine Firefox is using.
     */
    THUNDERBIRD(Manufacturer.MOZILLA, null, 110, "Thunderbird", new String[]{"Thunderbird"}, null, BrowserType.EMAIL_CLIENT,
            RenderingEngine.GECKO, "Thunderbird\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?(\\.[\\w]+)?)"),  // using
                                                                                                     // Gecko
                                                                                                     // Engine
    THUNDERBIRD12(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 185, "Thunderbird 12", new String[]{"Thunderbird/12"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    THUNDERBIRD11(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 184, "Thunderbird 11", new String[]{"Thunderbird/11"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    THUNDERBIRD10(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 183, "Thunderbird 10", new String[]{"Thunderbird/10"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    THUNDERBIRD8(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 180, "Thunderbird 8", new String[]{"Thunderbird/8"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    THUNDERBIRD7(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 170, "Thunderbird 7", new String[]{"Thunderbird/7"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    THUNDERBIRD6(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 160, "Thunderbird 6", new String[]{"Thunderbird/6"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    THUNDERBIRD3(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 130, "Thunderbird 3", new String[]{"Thunderbird/3"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    THUNDERBIRD2(Manufacturer.MOZILLA, Browser.THUNDERBIRD, 120, "Thunderbird 2", new String[]{"Thunderbird/2"}, null,
            BrowserType.EMAIL_CLIENT, RenderingEngine.GECKO, null),  // using Gecko Engine
    
    SEAMONKEY(Manufacturer.OTHER, null, 15, "SeaMonkey", new String[]{"SeaMonkey"}, null, BrowserType.WEB_BROWSER, RenderingEngine.GECKO,
            "SeaMonkey\\/(([0-9]+)\\.?([\\w]+)?(\\.[\\w]+)?)"), // using Gecko Engine
    
    BOT(Manufacturer.OTHER, null, 12, "Robot/Spider", new String[]{
        "Googlebot",
        "Web Preview",
        "bot",
        "spider",
        "crawler",
        "Feedfetcher",
        "Slurp",
        "Twiceler",
        "Nutch",
        "BecomeBot"}, null, BrowserType.ROBOT, RenderingEngine.OTHER, null), BOT_MOBILE(Manufacturer.OTHER, Browser.BOT, 20,
            "Mobil Robot/Spider", new String[]{"Googlebot-Mobile"}, null, BrowserType.ROBOT, RenderingEngine.OTHER, null),
    
    MOZILLA(Manufacturer.MOZILLA, null, 1, "Mozilla", new String[]{"Mozilla", "Moozilla"}, new String[]{"ggpht.com"},
            BrowserType.WEB_BROWSER, RenderingEngine.OTHER, null), // rest of the mozilla browsers
    
    CFNETWORK(Manufacturer.OTHER, null, 6, "CFNetwork", new String[]{"CFNetwork"}, null, BrowserType.UNKNOWN, RenderingEngine.OTHER, null), // Mac
                                                                                                                                            // OS
                                                                                                                                            // X
                                                                                                                                            // cocoa
                                                                                                                                            // library
    
    EUDORA(Manufacturer.OTHER, null, 7, "Eudora", new String[]{"Eudora", "EUDORA"}, null, BrowserType.EMAIL_CLIENT, RenderingEngine.OTHER,
            null),  // email client by Qualcomm
    
    POCOMAIL(Manufacturer.OTHER, null, 8, "PocoMail", new String[]{"PocoMail"}, null, BrowserType.EMAIL_CLIENT, RenderingEngine.OTHER, null),
    
    THEBAT(Manufacturer.OTHER, null, 9, "The Bat!", new String[]{"The Bat"}, null, BrowserType.EMAIL_CLIENT, RenderingEngine.OTHER, null), // Email
                                                                                                                                           // Client
    
    NETFRONT(Manufacturer.OTHER, null, 10, "NetFront", new String[]{"NetFront"}, null, BrowserType.MOBILE_BROWSER, RenderingEngine.OTHER,
            null), // mobile device browser
    
    EVOLUTION(Manufacturer.OTHER, null, 11, "Evolution", new String[]{"CamelHttpStream"}, null, BrowserType.EMAIL_CLIENT,
            RenderingEngine.OTHER, null), // http://www.go-evolution.org/Camel.Stream
    
    LYNX(Manufacturer.OTHER, null, 13, "Lynx", new String[]{"Lynx"}, null, BrowserType.TEXT_BROWSER, RenderingEngine.OTHER,
            "Lynx\\/(([0-9]+)\\.([\\d]+)\\.?([\\w-+]+)?\\.?([\\w-+]+)?)"),
    
    DOWNLOAD(Manufacturer.OTHER, null, 16, "Downloading Tool", new String[]{"cURL", "wget", "ggpht.com", "Apache-HttpClient"}, null,
            BrowserType.TOOL, RenderingEngine.OTHER, null),
    
    UNKNOWN(Manufacturer.OTHER, null, 14, "Unknown", new String[0], null, BrowserType.UNKNOWN, RenderingEngine.OTHER, null), @Deprecated
    APPLE_MAIL(Manufacturer.APPLE, null, 51, "Apple Mail", new String[0], null, BrowserType.EMAIL_CLIENT, RenderingEngine.WEBKIT, null); // not
                                                                                                                                         // detectable
                                                                                                                                         // any
                                                                                                                                         // longer.
    
    /*
     * An id for each browser version which is unique per manufacturer.
     */
    private final short id;
    private final String name;
    private final String[] aliases;
    private final String[] excludeList; // don't match when these values are in the agent-string
    private final BrowserType browserType;
    private final Manufacturer manufacturer;
    private final RenderingEngine renderingEngine;
    private final Browser parent;
    private List<Browser> children;
    private Pattern versionRegEx;
    private static List<Browser> topLevelBrowsers;
    
    private Browser(Manufacturer manufacturer, Browser parent, int versionId, String name, String[] aliases, String[] exclude,
            BrowserType browserType, RenderingEngine renderingEngine, String versionRegexString)
    {
        this.id = (short) ((manufacturer.getId() << 8) + (byte) versionId);
        this.name = name;
        this.parent = parent;
        this.children = new ArrayList<Browser>();
        this.aliases = toLowerCase(aliases);
        this.excludeList = toLowerCase(exclude);
        this.browserType = browserType;
        this.manufacturer = manufacturer;
        this.renderingEngine = renderingEngine;
        if (versionRegexString != null) this.versionRegEx = Pattern.compile(versionRegexString);
        if (this.parent == null) addTopLevelBrowser(this);
        else
            this.parent.children.add(this);
    }
    
    private static String[] toLowerCase(String[] strArr)
    {
        if (strArr == null) return null;
        String[] res = new String[strArr.length];
        for (int i = 0; i < strArr.length; i++)
        {
            res[i] = strArr[i].toLowerCase();
        }
        return res;
    }
    
    // create collection of top level browsers during initialization
    private static void addTopLevelBrowser(Browser browser)
    {
        if (topLevelBrowsers == null) topLevelBrowsers = new ArrayList<Browser>();
        topLevelBrowsers.add(browser);
    }
    
    public short getId()
    {
        return id;
    }
    
    public String getName()
    {
        return name;
    }
    
    private Pattern getVersionRegEx()
    {
        if (this.versionRegEx == null)
        {
            if (this.getGroup() != this) return this.getGroup().getVersionRegEx();
            else
                return null;
        }
        return this.versionRegEx;
    }
    
    /**
     * Detects the detailed version information of the browser. Depends on the userAgent to be available.
     * Returns null if it can not detect the version information.
     * @return Version
     */
    public Version getVersion(String userAgentString)
    {
        Pattern pattern = this.getVersionRegEx();
        if (userAgentString != null && pattern != null)
        {
            Matcher matcher = pattern.matcher(userAgentString);
            if (matcher.find())
            {
                String fullVersionString = matcher.group(1);
                String majorVersion = matcher.group(2);
                String minorVersion = "0";
                if (matcher.groupCount() > 2) // usually but not always there is a minor version
                    minorVersion = matcher.group(3);
                return new Version(fullVersionString, majorVersion, minorVersion);
            }
        }
        return null;
    }
    
    /**
     * @return the browserType
     */
    public BrowserType getBrowserType()
    {
        return browserType;
    }
    
    /**
     * @return the manufacturer
     */
    public Manufacturer getManufacturer()
    {
        return manufacturer;
    }
    
    /**
     * @return the rendering engine
     */
    public RenderingEngine getRenderingEngine()
    {
        return renderingEngine;
    }
    
    /**
     * @return top level browser family
     */
    public Browser getGroup()
    {
        if (this.parent != null)
        {
            return parent.getGroup();
        }
        return this;
    }
    
    /*
     * Checks if the given user-agent string matches to the browser. Only checks for one specific browser.
     */
    public boolean isInUserAgentString(String agentString)
    {
        if (agentString == null) return false;
        
        String agentStringLowerCase = agentString.toLowerCase();
        for (String alias : aliases)
        {
            if (agentStringLowerCase.contains(alias)) return true;
        }
        return false;
    }
    
    /**
     * Checks if the given user-agent does not contain one of the tokens which should not match. In most cases
     * there are no excluding tokens, so the impact should be small.
     * @param agentString
     * @return
     */
    private boolean containsExcludeToken(String agentString)
    {
        if (agentString == null) return false;
        
        if (excludeList != null)
        {
            String agentStringLowerCase = agentString.toLowerCase();
            for (String exclude : excludeList)
            {
                if (agentStringLowerCase.contains(exclude)) return true;
            }
        }
        return false;
    }
    
    private Browser checkUserAgent(String agentString)
    {
        if (this.isInUserAgentString(agentString))
        {
            
            if (this.children.size() > 0)
            {
                for (Browser childBrowser : this.children)
                {
                    Browser match = childBrowser.checkUserAgent(agentString);
                    if (match != null)
                    {
                        return match;
                    }
                }
            }
            
            // if children didn't match we continue checking the current to prevent false positives
            if (!this.containsExcludeToken(agentString))
            {
                return this;
            }
            
        }
        return null;
    }
    
    /**
     * Iterates over all Browsers to compare the browser signature with the user agent string. If no match can
     * be found Browser.UNKNOWN will be returned. Starts with the top level browsers and only if one of those
     * matches checks children browsers. Steps out of loop as soon as there is a match.
     * @param agentString
     * @return Browser
     */
    public static Browser parseUserAgentString(String agentString)
    {
        return parseUserAgentString(agentString, topLevelBrowsers);
    }
    
    /**
     * Iterates over the given Browsers (incl. children) to compare the browser signature with the user agent
     * string. If no match can be found Browser.UNKNOWN will be returned. Steps out of loop as soon as there
     * is a match. Be aware that if the order of the provided Browsers is incorrect or if the set is too
     * limited it can lead to false matches!
     * @param agentString
     * @return Browser
     */
    public static Browser parseUserAgentString(String agentString, List<Browser> browsers)
    {
        for (Browser browser : browsers)
        {
            Browser match = browser.checkUserAgent(agentString);
            if (match != null)
            {
                return match; // either current operatingSystem or a child object
            }
        }
        return Browser.UNKNOWN;
    }
    
    /**
     * Returns the enum constant of this type with the specified id. Throws IllegalArgumentException if the
     * value does not exist.
     * @param id
     * @return
     */
    public static Browser valueOf(short id)
    {
        for (Browser browser : Browser.values())
        {
            if (browser.getId() == id) return browser;
        }
        
        // same behavior as standard valueOf(string) method
        throw new IllegalArgumentException("No enum const for id " + id);
    }
    
}
